ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT redefines a contiguous subregion of an existing two-
dimensional texture image. The texels referenced by _p_i_x_e_l_s replace the
portion of the existing texture array with x indices _x_o_f_f_s_e_t and
_x_o_f_f_s_e_t+_w_i_d_t_h-1, inclusive, and y indices _y_o_f_f_s_e_t and _y_o_f_f_s_e_t+_h_e_i_g_h_t-1,
inclusive (But, see discussion of GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX below). This region
may not include any texels outside the range of the texture array as it
was originally specified. It is not an error to specify a subtexture
with zero width or height, but such a specification has no effect.
When GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is disabled, then counting from zero, each Nth
texel from _p_i_x_e_l_s is assigned to texture array indices [_i,_j], where _i =
_x_o_f_f_s_e_t+(N mod _w_i_d_t_h) and _j = _y_o_f_f_s_e_t+((N div _w_i_d_t_h) mod _h_e_i_g_h_t).
If GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is enabled, then every other row of the destination
texture is skipped. That is, the destination row for texel N is
_y_o_f_f_s_e_t+2((N div _w_i_d_t_h) mod _h_e_i_g_h_t). A complete video frame may be
assembled in texture memory by invoking ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT on two
consecutive video fields, with _y_o_f_f_s_e_t values that differ by one.
NNNNOOOOTTTTEEEESSSS
Texturing has no effect in color index mode.
ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr modes affect texture images in exactly
the way they affect ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
EEEERRRRRRRROOOORRRRSSSS
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated when _t_a_r_g_e_t is not one of the allowable
values.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated when the texture array has not been
defined by a previous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD operation.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than zero or greater than
log2(_m_a_x), where _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h < -TEXTURE_BORDER or if
_h_e_i_g_h_t < -TEXTURE_BORDER, where TEXTURE_BORDER is the border width of the
texture array.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _x_o_f_f_s_e_t<-TEXTURE_BORDER,
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is executed
between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
Convolution is supported only on RealityEngine, RealityEngine2, and VTX
systems. However, these systems do not support convolving images as they
are loaded into texture memory.
Histogramming and minmax are supported only on RealityEngine,
RealityEngine2, and VTX systems. However, these systems do not support
either operation on images as they are being loaded into texture memory.
ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is supported only on RealityEngine, RealityEngine2,
and VTX systems. On these systems the following apply:
1. Performance is significantly better if the texture subimage
xoffset, yoffset, width and height are multiples of 32.
2. ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT may be used only with a texture that was
created using ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD with a NULL texture image.
3. The only supported texel format and type combinations are:
GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE and
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE,
GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____RRRRGGGGBBBB and
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE and GGGGLLLL____RRRRGGGGBBBBAAAA and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE. Any other
4. Using ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT in conjunction with pixel mapping
results in a GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN error (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr and
ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp).
5. ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT may not be used in display lists or when
rendering remotely.
6. GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ggggllllEEEEnnnnaaaabbbblllleeee).
